Docs

ARexxWebServer V1.1 (ARWS)
By Casey Halverson
Copyright 1996, All Rights Reserved


DISCLAIMER:

This software is AS IS with no warranty implied.  If you some how format your hard-drive or 
blow up your computer with this ARexx script, you should be evaluated for a mental condition.
You may change all you want, but when transfering this software archive, be sure to keep it
fully intact as the original.  Also, EMail me your latest and greatest, since I would love
to see what you have done.  If it is good, i will include it as a sample in my next release.

I think I have fixed the security problem.  By scanning for :'s and double //'s, this should
keep people from retrieving files they shouldn't be.  However, if this does not work out properly,
I am still not responsible for what happens.


INTRODUCTION:

Who needs a compiled program, when you can have much more fun in ARexx?  This is a web
server for those who wish to have more control over their web server. 


INSTALLING:

1. Copy webserver.rexx to amitcp:bin/ or whatever your software/directory is.

* For AmiTCP:

Edit your amitcp:db/identd and type:

arws	stream	tcp dos bin - rx amitcp:bin/webserver.rexx

Edit your amitcp:db/services and type:

http 		80/tcp		http

* For Miami:

Open Miami, select database and then select "Identd".

Add the entry:

arws stream tcp dos bin - rx amitcp:bin/webserver.rexx

You can change amitcp:bin/webserver.rexx to whereever you stored it.

Select "Services", and type the following:

http 80 tcp


CONFIGURING:

Simply pull it up in a text editor, change the path="amitcp:www" to whatever you have your 
pages, or simply store them in amitcp:www since it does make sense.  You can change whatever
you want below, but be sure you know what you are doing.  I always keep a backup copy of it
before I start doing something totaly weird, because most of the time I will screw up and be
totaly lost :-)  

One small note you should consider in changing the path.  *NEVER* put a '/' after the directory
(you can have a :).  This will cause problems.


CGI-BIN OPERATION:

The cgi-bin is simply a way to execute other ARexx scripts.  When a *.cgi file is requested via
http, and the cgi exists in the cgi-bin, the web server will spawn the 

The cgi-bin also has a function which allows special tags to be placed in the HTML file, allowing
an arexx command to execute at that very line.  After the program completes, the HTML file continues
to print.

I have included Disco-Duck's CGI script he wrote as an example of what can be done with this.

Please note that when creating an imbeded CGI tag, keep it on a line by it's self.  The parsing 
routine will not pick out any other imbeded tags on the same line.  However, text or HTML tags
will show up just as normal.


CONTACTING:

If you like this program, please give me an EMail.  I would love to hear from you!  Also, if you
made any neat little changes to the server program (IE: search engine, web game, etc), please send
what you have.

You may contact me in the following ways:

EMail:

cmdo@gte.net

Snail-Mail:

Casey Halverson
1517 105th Ave Ct E
Puyallup, WA 98372

ATTN: RexxWebServer